home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / info-service / gopher / Unix / gateways / gonnrp / how_to_gonnrp < prev    next >
Encoding:
Text File  |  1993-06-08  |  4.1 KB  |  147 lines
  1. Quick start guide for the gopher-nnrp gateway
  2.  
  3. Requirements: perl, sys/socket.ph, an NNTP server that supports XHDR
  4. If the nntp server is not INN with overview files it will be slow for
  5. large newsgroups as the overview files speed up xhdr quite a bit.
  6.  
  7. Notes: If running chroot(), be sure to have perl and sys/socket.ph
  8. in the gopher space.  All the paths in the code assume you are running
  9. chroot.
  10.  
  11. gonnrp has several options: (some of these options were ported over from
  12. gonntp and have not yet been tested it gonnrp.  They are marked as
  13. such.)
  14.  
  15. -g pattern    retrieve all matching groups (as shipped gonnrp only
  16.                 matches with the beginning of the group name)
  17.         Does not split up groups on '.'s like -G does.
  18.  
  19. -h group    retrieve subject headers from specified group
  20.  
  21. -b group    same as -h, but sets up next level to only display
  22.         the body of the article (no headers) (untested in
  23.         gonnrp)
  24.  
  25. -s group keyword    same a -h but display only subject lines
  26.             which contain keyword. Currently limited to
  27.             one word, should be easily fixed for more.
  28.             To use this from gopher, you will have to call
  29.             a shell script to run gonnrp rather than exec'ing
  30.             gonnrp directly. I am still working on the 
  31.             search stuff, may change it later...
  32.             (untested in gonnrp)
  33.  
  34. -a group # [body]    Internal option to retrieve article # from
  35.             group. If body is specified then only the
  36.             body of the article is displayed (no headers).
  37.             The -a option should never be used in a .link
  38.             file unless you never get rid of news articles.    
  39.  
  40. -l group        Show last article from a group. Added by 
  41.             Bob Peterson (peterson@choctaw.csc.ti.com)
  42.             (untested in gonnrp)
  43.  
  44. -G pattern        Same as -g, except prepare to thread groups
  45.             and split groups on '.'s into sub-menus
  46.  
  47. -G            same as -G pattern but all newsgroups
  48.  
  49. -T group        Same as -h except thread articles.
  50.  
  51. -X art# art#         Show authors from thread.  This option has two
  52. -X 0 start end        forms.  The first gives a list of articles in
  53.             the thread.  If the list is too long the
  54.             second is used.  It gives the first and last
  55.             articles numbers in the thread.  Any articles in
  56.             the range that are not part of the thread are
  57.             skipped.
  58.  
  59. -t group        Same as -h.  I kept it to make converting from gonntp
  60.             easyer.  I might take it out in the future so do
  61.             not use it.
  62.  
  63. -f filepath        Used to add a file to the begining of the menu.
  64.             We use it for the clari copyright warning.
  65.  
  66. Setting up the files:
  67.  
  68. All paths are showen relative to the gopher's chrooted root.
  69.  
  70. /bin/gonnrp
  71. /bin/build-newsgroups-db    (run by maintainer only)
  72. /usr/lib/dotall            (used by build-newsgroups-db)
  73. /usr/lib/newsgroups.dir        (built by build-newsgroups-db)
  74. /usr/lib/newsgroups.pag        (built by build-newsgroups-db)
  75.  
  76. cd to gopher's /bin and type this:
  77.  
  78. build-newsgroups-db /usr/local/news/newsgroups ../usr/lib/dotall
  79.  
  80. It will setup your newsgroups dbm database that is used to display the
  81. descriptions in the newsgroups menus.  The dotall file contains
  82. descriptions of parts of the newsgroups for the menus.  For example:
  83.  
  84. A dotall entry of:
  85.  
  86. news.admin.all    newsgroups for news admins
  87.  
  88. The description 'newsgroups for news admins' would appear next to
  89. 'news.admin' in gopher.  Note that this info can not be gotten from the
  90. newsgroups file because news.admin is not a newsgroup.  [I know I picked
  91. an example that used to be a newsgroup and still is one, incorrectly, at
  92. some sites.]
  93.  
  94. Sample link files
  95.  
  96. Name=comp
  97. Type=1
  98. Path=exec:-g comp:/bin/gonnrp
  99. Host=+
  100. Port=+
  101.  
  102. Name=Comp.Sys groups
  103. Type=1
  104. Path=exec:-g comp.sys:/bin/gonnrp
  105. Host=+
  106. Port=+
  107.  
  108. Name=Gopher News
  109. Type=1
  110. Path=exec:-h alt.gopher:/bin/gonnrp
  111. Host=+
  112. Port=+
  113.  
  114. Name=No headers alt.gopher
  115. Type=1
  116. Path=exec:-b alt.gopher:/bin/gonnrp
  117. Host=+
  118. Port=+
  119.  
  120. Name=Search alt.gopher subjects for keyword
  121. Type=7
  122. Path=7/bin/gonnrp.sh
  123. Port=+
  124. Host=+
  125. #
  126. Name=clari - ClariNet UPI wireservice news
  127. Numb=5
  128. Type=1
  129. Path=exec:-f /usr/lib/clari-copyright -G clari:/bin/gonnrp
  130. Host=+
  131. Port=+
  132.  
  133. (gonnrp.sh is a shell script which execs gonnrp -s alt.gopher $*, the
  134. exec type will try to exec "/bin/gonnrp keyword" rather than 
  135. exec "/bin/gonnrp" "keyword")
  136.  
  137. i.e.:
  138.  
  139. #!/bin/sh
  140.  
  141. /bin/gonnrp -s alt.gopher $*
  142.  
  143. Comments & Suggestions to:
  144.  
  145. c-adams@bgu.edu (Chad Adams)
  146.  
  147.